Creación y edición de paletas de secuencias de comandos

Las secuencias de comandos de documentos pueden crearse, guardarse y ejecutarse dentro de un archivo Vectorworks. Los scripts deben estar anidados en carpetas de paletas de secuencias de comandos. Usar el Administrador de recursos para gestionar carpetas de paletas de secuencias de comandos así como secuencias de comandos de documentos individuales.

Creación de secuencias de comandos

Para crear una secuencia de comandos:

En el Administrador de recursos, haga clic en Nuevo recurso, seleccione Secuencia de comandos y, a continuación, haga clic en Crear. Como alternativa, en el Administrador de recursos, seleccione Guiones en la lista de tipos de recursos de la barra de herramientas y haga clic en Nuevo guión.

Los scripts deben colocarse en una carpeta de la paleta de secuencias de comandos. Realice una de las siguientes acciones:

Si existen paletas de secuencias de comandos en el archivo, se abre el cuadro de diálogo Seleccionar paleta de secuencias de comandos; seleccione la paleta a la que desea añadir la secuencia de comandos y haga clic en Seleccionar, o haga clic en Nueva paleta para crear una paleta.

Si no existe ninguna paleta de secuencias de comandos, se autogenerará una nueva paleta; introduzca un nombre para la nueva paleta.

Se abre el cuadro de diálogo Asignar nombre. Introducir el nombre de la secuencia de comandos.

El Editor de secuencia de comandos se abre para iniciar una sesión de edición de secuencias de comandos. Seleccione el lenguaje de comandos para la secuencia de comandos: Python Script o VectorScript. El editor proporciona un entorno de creación básico para el desarrollo y mantenimiento de scripts. Sus funciones le permiten crear, editar y compilar scripts, examinar las funciones disponibles, ver errores y realizar otras tareas asociadas con la creación de scripts. El Editor de secuencia de comandos ofrece una funcionalidad de insinuaciones de código para ayudar a reducir los errores al crear secuencias de comandos, incluyendo la coincidencia de corchetes, consejos de llamada y autocompletado. Las secuencias de comandos tienen un límite de 32.001 caracteres. Para obtener documentación detallada orientada al programador relacionada con Python y VectorScript, navegue hasta developer.vectorworks.net.

Pulse aquí para mostrar u ocultar los parámetros.Pulse aquí para mostrar u ocultar los parámetros.

Parámetro

Descripción

Menú Editor

 

Procedimiento

Abre el cuadro de diálogo Procedimientos, que incluye todas las funciones/procedimientos de script disponibles por categoría y proporciona un prototipo así como una breve descripción de qué operación realiza la función/procedimiento. La lista sirve tanto de referencia como de medio aritmético para construir el código pegando la función/procedimiento correspondiente en el editor. Introducir texto en el cuadro de búsqueda para filtrar la lista.

Seleccione el procedimiento o función y haga clic en Aceptar para añadirlo a la línea actual del editor de secuencias de comandos.

Criterios

Abre el cuadro de diálogo de criterios, para definir automáticamente los criterios de selección en una secuencia de comandos (véase El cuadro de diálogo Criterios).

Herramienta/Atributo

Abre el cuadro de diálogo Herramientas personalizadas, para guardar la información del estado actual de herramientas y atributos en una secuencia de comandos (consulte Creación de secuencias de comandos de herramientas/atributos personalizados)

Parámetro

El comando Parámetro proporciona acceso a la lista de parámetros de un objeto de complemento para su edición, cuando se trabaja en la secuencia de comandos de un complemento (consulte Definición de un Definición del complemento)

Archivo de Texto

El comando Archivo de Texto permite importar el código fuente de comandos desde archivos de texto externos.

Compilar secuencia de comandos

El botón Compilar script permite compilar un script directamente desde el Editor de scripts sin necesidad de ejecutarlo. Si existen errores en el script que impiden la compilación correcta, se mostrarán y podrán resolverse sin necesidad de salir del editor de scripts.

Mientras que la compilación de VectorScripts informa de todos los errores en el código del script, la compilación de scripts Python informa sólo de los errores de sintaxis. Por ejemplo, una variable indefinida no se notifica como error para las secuencias de comandos Python, porque este tipo de error sólo se determina durante la ejecución del script. Como resultado, las secuencias de comandos Python informan de la mayoría de los errores cuando se ejecutan.

Buscar y Reemplazar

Abre el cuadro de diálogo Buscar y Reemplazar para buscar texto en el script actual y, opcionalmente, reemplazar una instancia o todas las instancias de una palabra.

Deshacer/Rehacer

Deshace la última acción, o rehace la acción de deshacer que se acaba de completar; los mismos atajos de teclado que activan el comando principal de Vectorworks Deshacer (Ctrl+Z Windows, y Cmd+Z Mac) y el comando Rehacer (Ctrl+Y Windows, y Cmd+Y Mac) activan las funciones de este cuadro de diálogo

Mostrar/Ocultar caracteres especiales

Activa o desactiva la visualización de los símbolos de espacio, pestaña y CR/LF (salto de línea).

Idioma

Selección de Python o VectorScript como lenguaje de script.

Opciones de secuencia de comandos

(sólo secuencias de comandos Python)

Abre el cuadro de diálogo Opciones de comandos, que incluye las carpetas (rutas de entorno) donde se localizan los módulos importados, para los scripts Python que requieren bibliotecas externas.

También se puede acceder a este cuadro de diálogo desde Herramientas > Complemento > Opciones de secuencia de comandos.

Añadir: Localice una carpeta para incluirla en la lista.

Quitar: Elimina la ubicación de carpeta actualmente seleccionada.

Abrir carpeta en SO: Muestra el contenido de la carpeta seleccionada en Windows o Mac.

Las secuencias de comandos pueden editarse, renombrarse, eliminarse, exportarse, importarse, moverse y ejecutarse desde el Administrador de recursos.

Editar secuencias de comandos

Para editar una secuencia de comandos existente:

En el Administrador de recursos, haga clic con el botón derecho en el recurso y seleccione Editar en el menú contextual. Los scripts están anidados en carpetas de la paleta de secuencias de comandos.

Se abrirá el Editor de secuencia de comandos, que mostrará el código de origen del script. Consulte Creación de secuencias de comandos para obtener una descripción del Editor de secuencias de comandos.

Cifrar secuencias de comandos

Comando

Ruta de acceso

Cifrar secuencia de comandos

Herramientas > Complementos

Cifrar una secuencia de comandos para impedir su edición.

Para cifrar un archivo de secuencia de comandos:

Seleccione el comando.

Se abre el cuadro de diálogo Elegir archivo de comandos.

Localice y seleccione el archivo de secuencia de comandos que desea cifrar.

Haga clic en Abrir.

Se abre el cuadro de diálogo Guardar documento de código VectorScript cifrado.

Introducir un Nuevo nombre para la secuencia de comandos y, a continuación, localizar la ubicación para guardar el archivo.

Haga clic en Guardar.

La secuencia de comandos se guarda en un formato cifrado.

Ejecutar secuencias de comandos

Administrador de recursos

Usar secuencias de comandos

 

¿Fue útil esta página?